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Foreword 

This Technical Specification (TS) has been produced by the 3^^ Generation Partnership Project (3GPP). 

The present document is part 3 of a multi-part TS covering the 3^^ Generation Partnership Project: Technical 
Specification Group Services and System Aspects, as identified below: 

Part 1 : "3G Fault Management Requirements"; 

Part 2: "Alarm Integration Reference Point: Information Service"; 

Part 3: "Alarm Integration Reference Point: CORBA Solution Set Version 1:1"; 

Part 4: "Alarm Integration Reference Point: CMIP Solution Set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document specifies the CORB A Solution Set (SS) for the IRP whose semantics is specified in Alarm IRP: 
Information Service (IS) (3G TS 32.111-2 [13]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. Clause 

5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. Clause 

6 defines the usage of OMG CORB A Structured Event to carry information defined in notifications carrying alarm 
information. Clause 7 describes the notification interface containing the push method. Annex A contains the IDL 
specification. 



References 



The following documents contain provisions, which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

[I] ITU-T Recommendation X.721: "Information technology - Open Systems Interconnection - 
Structure of management information: Definition of management information". 

[2] ITU-T Recommendation X.736: "Information technology - Open Systems Interconnection - 

Security Alarm Reporting Function". 

[3] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - 

Relationship Management Function". 

[4] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - State 

Management Function". 

[5] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - 

Object Management Function". 

[6] OMG TC Document telecom/98-1 1-01 : "OMG Notification Service". 

[7] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification). 

[8] 3G TS 32. 106-8: "Name Convention for Managed Objects". 

[9] 3G TS 32.106-1: "3G Configuration Management: Concept and Requirements". 

[10] 3G TS 32. 106-2: "Notification IRP: Information Service". 

[II] 3G TS 32.106-3: "Notification IRP: CORBA Solution Set". 

[11] ITU-T Recommendation X.735: "Information technology - Open Systems Interconnection - 

Systems Management: Log control function" . 

[12] 3G TS 32.111-1: "3G Fault Management". 

[13] 3G TS 32.1 1 1-2: "Alarm Integration Reference Point: Information Service". 

[14] 3G TS 32. 111-4: "Alarm Integration Reference Point: CMIP Solution Set". 
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Definitions and abbreviations 



3.1 Definitions 

In addition to the terms and definitions defined in TS 32.111-2 [13], there are no additional definitions applicable to the 
present document. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOI Managed Object Instance 

NE Network Element 

OMG Object Management Group 

TMN Telecommunications Management Network 

UML Unified Model Language 

3.3 IRP Solution Set version 

The version of this CORBA SS is 1:1, where the first "1" indicates the version number of the Alarm IRP: IS (3G TS 
32.111-2 [13]) and the second "1" indicates the version number of this document. 



4 Architectural Features 

The overall architectural feature of Alarm IRP is specified in 3G TS 32.111-2 [13]. This clause specifies features that 
are specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG TC Document telecom [6]). 

OMG Event Service provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotif ications notifications as specified in 3 G TS 32.111-2 [13]. 



4.2 Push and Pull Style 



OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 
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4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 

notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 

are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, 

IRP Agent shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, 

IRP Agent shall invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started 

after each push invocation. 



4.4 



Filter 



IRP Agent shall optionally support alarm filtering based on IRPManager' s supplied alarm filter constraints (e.g., as 
parameter in subscribe() of 3G TS 32.106-2 [10]. Alarm filtering can be applied in the following cases: 

• It is applicable to alarms emitted by IRP Agent via AlarmlRP Notifications. IRPManager supplies alarm 
filter constraint via the subscribe method. This filter is effective during the period of subscription. 

• It is applicable to alarms returned by IRP Agent via the out parameter of get_alarm_l i s t method. 
IRPManager supplies alarm filter constraint via the get_alarm_list method. This filter is effective only for 
this method invocation. 

• It is applicable to the calculation of alarm counts returned by IRP Agent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count method. 
This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference 3G TS 32.106-2 [6]. The name of the grammar is 
called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in 3G TS 32.106-2 [6]. This SS shall 
use this grammar only. 



5 Mapping 

5.1 Operation and Notification mapping 

Alarm IRP: IS 3G TS 32.111-2 [13] defines semantics of operation and notification visible across the Alarm IRP. Table 
1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table 1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 3G TS 32.111-2 [13] 


SS Method 


Qualifier 


acknowledge Alarms 


acknowledge_alarms 


M 


unacknowl edge Alarms 


unacknowl edge_al arms 





getAlarmList 


get_alarm_list 


M 


get AlarmlRP Vers ion 


get_alarm_IRP_version 


M 


getAlarmCount 


get_alarm_count 





notif yNewAlarm 


push_structured_event 

Note that OMG Notification Service 3G TS 32.106-2 

[6] defines this method. See clause 8.1 


M 


notifyClearedAlarm 


push_structured_event 
See clause 8.1 


M 


notifyChangedAlarm 


push_structured_event 
See clause 8.1 


M 


notifyAckStateChanged 


push_structured_event 
See clause 8.1 


M 


not IfyAlarmLi St Rebuilt 


push_structured_event 
See clause 8.1 


M 
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5.2 Operation parameter mapping 

Reference 3G TS 32.111-2 [13] defines semantics of parameters carried in operations across the Alarm IRP. Table2 
and table 3 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS acknowiedgeAiarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnf ormation 
ReferenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
a 1 a rm_i n f o rma t i on_i d_l i s t 


M 


ackUserld 


string ack_user_id 


M 


ackSystemId 


string ack_system_id 





bad Alarmlnformation 
ReferenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_information_id_list 


M 


status 


CommonlRPConstDef s : : Signal 
Exceptions: 

AcknowiedgeAiarms, ParameterNot Supported, 
InvalidParameter 


M 



Table 3: Mapping from IS unacknowiedgeAiarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarm 

Inf ormationRef erenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
alarm_inf ormation_id_list 


M 


ackUserld 


string ack_user_id 


M 


ackSystemId 


string ack_system_id 





badAlarm Information 
ReferenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 


M 


status 


CommonlRPConstDef s : : Signal 
Exceptions: 

UnacknowiedgeAiarms, OperationNot Supported, 
ParameterNot Supported, InvalidParameter 


M 



Table 4: Mapping from IS getAiarmList parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 





alarmlnformation List 


Return value of type 

AlarmlRPConstDef s : : Alarmlnf ormationSeq 


M 


status 


Exceptions : 

GetAiarmList, ParameterNot Supported, 
InvalidParameter 


M 



Table 5: Mapping from IS getAiarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 





criticalCount, majorCount, 
minorCount, warningCount , 
indeterminateCount, clearedC 
ount 


long critical_count, long major_count, long 
minor_count, long warning_count , long 
indeterminate_count, long cleared_count 


M 


status 


Exceptions: 

GetAiarmCount, OperationNot Supported, 
ParameterNot Supported, InvalidParameter 


M 
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Table 6: Mapping from IS getAiarmiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberList 


Return value of type 

CommonlRPConstDef s : : VersionNumberSet 


M 


status 


Exceptions: 

GetAiarmiRPVersion 


M 



5.3 Notification parameter mapping 



Reference 3G TS 32.111-2 [13] defines semantics of parameters carried in notifications across the Alarm IRP. Table 7 
and table 8 indicate the mapping of these parameters, as per notification, to their equivalents defined in this SS. 

Table 7 and table 8 are relevant for notif yNewAlarm, notif yChangedAlarm, notif yClearedAlarm^ 
not if yAckStateChanged . 

Table 7: Mapping from IS notify [New, changed. Cleared] Alarm and notif yAckStateChanged 

parameters to SS equivalents 



IS Notification 
parameter 


SS Notification 
parameter 


Comment 


notification 
Header 


structuredEvent 
Note that OMG 
Notification Service [6] 
defines this 

StructuredEvent. 
See Clause 4 as well. 


Attributes of notif icationHeader are mapped to attributes of 
StructuredEvent. See clause 6.4 for attributes related to 
notificationHeader. See Table 9 for qualifiers for the parameter- 
attributes. 

For notif yNewAlarm, notifyChangedAlarm, 
notifyClearedAlarm and notif yAckStateChanged, the 
extendedE vent Type shall contain a string of 

extendedEvent TypeValue . NOTIFY_FM_NEW_ALARM, 
extendedEvent TypeValue . NOTIFY_FM_CHANGED_ALARM, 
extendedEvent TypeValue . NOTIFY_FM_CLEARED_ALARM, 
extendedEvent TypeValue . NOTIFY_FM_ACK_STATE_CHANGED 
respectively. 


alarm 

Information 

Body 


StructuredEvent 


Attributes of alarmln format ion Body are mapped to attributes of 
StructuredEvent. See clause 6.4 for attributes related to 
alarmlnformat ion Body. See table 10 for qualifiers for the 
parameter-attributes . 



Table 8 is relevant for notif yAlarmListRebuilt. 

Table 8: Mapping from IS notif yAlarmListRebuilt parameters to SS equivalents 



IS Notification parameter 


SS equivalent 


Comment 


notification Header 


structured 
Event 


The managedObject Class, systemDN shall be absent. The 

event Type shall contain a zero-length string. 

The extendedEvent Type shall contain a string of 

extendedEventTypeValue.NOTIFY_FM_ALARM_LIST_REB 

UILT. 

The managedObject Instance shall carries the DN of the 

IRP Agent whose Alarm List has been rebuilt. Syntax and semantics 

of this string conform to the Managed Object string representation 

specified in [8]. 

See clause 6.4 for attributes related to notificationHeader. 

See Table 9 for qualifiers for the parameter-attributes. 


reason 


reason 


It is a string indicating the Alarm List rebuilt reason. 
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5.4 Parameter Attribute mapping 



Notification IRP: IS 3G TS 32.106-2 [10] defines the semantics of attributes for notif icationHeader parameter. 
Alarm IRP: IS 3GTS 32.111-2 [13] identifies notif icationHeader for use for its IRP. 3G TS 32.111-2 [13] also 
qualifies the attributes of the notif icationHeader parameter. Table 9 shows the mapping of these IS attributes to 
SS equivalents. 

Table 9: Mapping from IS notif icationHeader attributes to SS equivalents 



IS Attribute of notif icationHeader in [10] 


SS Attribute 


Qualifier 


managedOb jectClass 


managedOb jectClass 





managedObject Instance 


managedOb ject Instance 


M 


notif icat ion ID 


notif icat ion ID 


M 


eventTime 


eventTime 


M 


systemDN 


systemDN 


M 


eventType 


eventType 


M 


extendedE vent Type 


extendedE vent Type 


M 



Alarm IRP: IS 3G TS 32.111-2 [13] defines and qualifies the semantics of attributes for alarmlnf ormationBody 
parameter. The following table shows the mapping of these IS attributes to SS equivalents. 

Table 10: Mapping from IS aiarminf ormationBody attributes to SS equivalents 



IS Attribute of aiarminf ormationBody in 
3GTS 32.111-2 [13] 


SS Attribute 


Qualifier 


probableCause 


probableCause 


M 


perceivedSeverity 


perceivedSeverity 


M 


specif icProblem 


specif icProblem 





correlatedNot if icat ions 


correlatedNot if icat ions 





backedUpStatus 


backedUpStatus 





backUpOb ject 


backUpOb ject 





trendlndication 


trendlndication 





thresholdlnfo 


thresholdlnfo 





stateChangeDef inition 


StateChangeDef inition 





monit or edAt tributes 


monit or edAt tributes 





proposedRepairActions 


proposedRepairActions 





additional Text 


additional Text 





additionalinf ormation . alarmld 


alarmld 


M 


additionallnformation. ackTime 


ackTime 


note 1 


additionalinf ormation . ackUserld 


ackUserld 


note 1 


additionallnformation . ackSystemId 


ackSystemId 


note 1 


additionallnformation. ackState 


ackState 


note 1 


NOTE 1: See qualification information in 3G TS 32.111-2 13], Table 13: Parameter-Attributes of 

aiarminf ormationBody. 
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Use of OMG Structured Event 



Operation notify defined in 3G TS 32.111-2 [13] carries parameters, such as notif icationHeader and 
alarmlnf ormationBody. In CORBA SS, OMG defined StructuredEvent (see ITU-T Recommendation 
X.736 [2]) is used to carry notification. This clause identifies the OMG defined StructuredEvent attributes that 
carry the attributes of parameters defined in 3GTS 32.111-2 [13]. 

The composition of OMG Structured Event, as defined in the OMG TC Document telecom [6], is: 

Header 

Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 



Body 



fi Iter able_body_fie Ids 
remaining_body 



Table 1 1 Hsts all OMG Structured Event attributes in the second column. The first column identifies the SS attributes, 
if any, that shall be carried in the Structured Event attributes. 
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Table 1 1 : Use of OMG Structured Event 



SS Attribute 


OMG CORBA 

Structured Event 

attribute 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 


It contains a string defined by interface 

IRPNotif icationCategoryValue . alarmIRPVersion_l_l. 
It indicates the syntax and semantics of this Structured Event is defined by 
Alarm IRP: CORBA SS 1:1. 


eventType 


type_name 


Attribute eventType is an attribute of notif icationHeader. 
It shall indicate one of the following ITU-T defined semantics: 
communications alarm, processing error alarm, environmental alarm, 
quality of service alarm and equipment alarm. 

It is a string. See block of const string definitions starting with "ET_" in 
the IDL. 


extendedEvent 
Type 


event_name 


Attribute extendedEvent Type is an attribute of 

notif icationHeader. 

It shall identify one of the following: 

• notify a new alarm 

• notify changes in alarm state 

• notify changes in alarm acknowledgement state 

• notify alarm cleared 

• notify Alarm List has been successfully rebuilt 

It is a string. See block of const string definitions starting with 
"NOTIFY_FM_" in the IDL. 


There is no 
corresponding SS 
attribute. 


variable 
Header 




managedOb ject 
Class, 

managedOb ject 
Instance 


One NV pair of 

f ilterable_ 
body_f ields 


NV stands for name-value pair. Order arrangement of NV pairs is not 

significant. The name of NV-pair is always encoded in string. 

They are attributes of notif icationHeader. 

Name of NV pair is a string, 

AttributeNameValue .managedOb ject Instance. 

Value of NV pair is a string. See corresponding table in Notification IRP: 

CORBA SS (3GTS 32.106-3 [11]). 


notification 
Id 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader. 

Name of NV pair is a string, 

AttributeNameValue . notif icationld. 

Value of NV pair is a long. See corresponding table in Notification IRP: 

CORBA SS (3GTS 32.106-3 [11]). 


eventTime 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader . 
Name of NV pair is AttributeNameValue .eventTime. 
Value of NV pair is a I RP T ime . See corresponding table in 
Notification IRP: CORBA SS (3G TS 32.106-3 [11]). 


systemDN 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader. 

Name of NV pair is a string, AttributeNameValue . systemDN. 
Value of NV pair is a string. See corresponding table in Notification IRP: 
CORBA SS [11]. 


probableCause 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue .probableCause. 

Value of NV pair is a short defined by ProbableCauseValue. 


perceived 
Severity 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, 

AttributeNameValue .perceivedSeverity. 

Value of NV pair is a short defined by PSJNDETERMINATE, 

PS_CRITICAL, etc. 


specific 


One NV pair of 


It is an attribute of alarmlnf ormationBody. 
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Problem 


f ilterable_ 
body_f ields 


Name of NV pair is a string, 

AttributeNameValue . specif icProblem. 
Value of NV pair is a string. 


correlated 
Notifications 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue . correlatedNotif ications. 
Value of NV pair is a CorrelatedNotif icationSetlype . 


backed 
UpStatus 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue .backedUpStatus. 

Value of NV pair is a boolean BackedUpStatusType. 


backUpOb ject 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, 

AttributeNameValue .backedUpStatus. 

Value of NV pair is a string carrying of DN of the back-up object. See 3G 

TS 32.106-8 [8] for the DN string representation. 


trend 
Indication 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue . trendlndication. 
Value of NV pair is an enum TrendlndicationType. 


thresholdlnfo 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

ParameterNameValue. thresholdlnfo. 

Value of NV pair is an enum ThresholdlndicationType. 


stateChange 
Definition 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue.stateChangeDef inition. 
Value of NV pair is an AttributeChangeSetType . 


monitored 
Attributes 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string. 

At tributeNameValue.monit or edAt tributes. 
Value of NV pair is an AttributeSetType. 


proposed 
RepairActions 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue.proposedRepairActions. 
Value of NV pair is a string. 


additional 
Text 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 
Name of NV pair is a string, 

AttributeNameValue. additional Text. 
Value of NV pair is a string. 


additional 
Information. a 
larmid 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string. At tributeNameValue.a larmid. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the default 

semantics is that a larmid is a concatenation of 

managedOb jectlnstance, eventlype, probableCause 

and specif icProblem, if present, of this Structured Event. Since 

probableCuaseis encoded as a short, it shall be converted into string 

before concatenation. The resultant string shall not contain spaces. 


additional 

Information. 

acklime 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader. 

Name of NV pair is a string, AttributeNameValue. acklime. 

Value of NV pair is a IRPTime. 


additional 

Information. 

ackUserld 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, AttributeNameValue. ackUserld. 

Value of NV pair is a string. 


additional 
Information . 


One NV pair of 

f ilterable_ 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, AttributeNameValue. ackSystemld. 
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ackSystemId 


body_f ields 


Value of NV pair is a string. 


additional 


One NV pair of 


It is an attribute of alarmlnf ormationBody. 


Information . 


f ilterable_bod 


Value of NV pair is a short defined by 


ackState 


y_f ields 


ACK_STATE_ACKNOWLEDGED and 
ACK_STATE_UNACKNOWLEDGED. 

Value of NV pair is a short defined by AlarmAckState. 


There is no 


remaining_ 




corresponding SS 


body 




attribute. 







AlarnnlRPNotifications Interface 



OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNot i float ions. All the 
notifications in this interface are implemented using this push_structured_event method. 

7.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_event s method takes an input parameter of type EventBatch as defined 
in the OMG CosNotification module (OMG TC Document telecom [6]). This data type is the same 
as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of 
Structured Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specification 

/^ ## Module: AlarmConstDef s 

This module contains commonly used definitions. 

^/ 

#ifndef AlarmlRPConstDef s_idl 
#def ine AlarmlRPConstDef s_idl 

#include "CosNotif ication . idl" 

#pragma prefix ^''SgppsaS . org'' 
module AlarmlRPConstDef s { 

This block identifies all TMN ITU-T defined event types used by Alarm 

IRP of this version. Their semantics are defined by ITU-T. Their 

encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

ITU-T defined event types for their use. They shall define their encodings 

as well. Note all values are unique among themselves. Other IRP documents 

can use the same values. 

V 

const string ET_COMMUNICATIONS_ALARM = "xl"; 

const string ET_PROCESSING_ERROR_ALARM = "x2"; 

const string ET_ENVIRONMENTAL_ALARM = "x3"; 

const string ET_QUALITY_OF_SERVICE_ALARM = "x4"; 

const string ET_EQUIPMENT_ALARM = "x5"; 

/^ 

This block identifies IRP defined, and not ITU-T defined, event types 

used by this Alarm IRP version. 

^/ 

const string NOTIFY_FM_NEW_ALARM = "xl"; 

const string NOTIFY_FM_CHANGED_ALARM = "x2"; 

const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 

const string NOTIFY_FM_CLEARED_ALARM = "x4"; 

const string NOTIFY_FM_ALARM_LIST_REBUILT = "x5"; 

/^ 

It indicates if an object has a back up. 

True implies backep up. False implies not backed up. 

V 

typedef boolean BackedUpStatusType; 

It indicates if the threshold crossed was in the up or down direction. 
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enum ThresholdlndicationType {Up, Down}; 

/^ 

It indicates if some observed condition is getting better, worse, 

or not changing. 

^/ 

enum TrendlndicationType {LessSevere, NoChange, MoreSevere}; 

It is used in a notification to report a changed attribute value. 
V 

struct AttributeValueChangeType { 
string attributeName; 

any oldValue; // type depends on attribute 
any newValue; // type depends on attribute 

}; 

typedef sequence <AttributeValueChangeType> AttributeChangeSetType; 

It is used in a notification to report a changed attribute value. 
V 

struct AttributeValueType { 
string attributeName; 
any value; // type will depend on the attribute 

}; 

typedef sequence <AttributeValueType> AttributeSetType; 



This block identifies the levels of severity. 
^/ 

const short PS_INDETERMINATE= 1; 
const short PS_CRITICAL= 2; 
const short PS_MAJOR= 3; 
const short PS_MINOR= 4; 
const short PS_WARNING= 5; 
const short PS_CLEARED= 6; 

/^ 

This block identifies the acknowledgement state reported alarm. 

V 

const short ACK_STATE_ACKNOWLEDGED= 1; 

const short ACK_STATE_UNACKNOWLEDGED= 2; 

This block identifies the probable cause of a reported alarm. 
V 

const short PC_INDETERMINATE = 0; 

const short PC_ALARM_INDICATION_SIGNAL = 1; 

const short PC_CALL_SETUP_FAILURE = 2; 

const short PC_DEGRADED_SIGNAL_M310 = 3; 

const short PC_FAR_END_RECEIVER_FAILURE = 4; 

const short PC_FRAMING_ERROR_M310 = 5; 

const short PC_LOSS_OF_FRAME = 6; 
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const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 



short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 
short 



PC_LOSS_OF_POINTER = 7; 
PC_LOSS_OF_SIGNAL = 8; 
PC_PAYLOAD_TYPE_MISMATCH = 9; 
PC_TRANSMISSION_ERROR = 10; 
PC_REMOTE_ALARM_INTERFACE = 11; 
PC_EXCESSIVE_BIT_ERROR_RATE = 12; 
PC_PATH_TRACE_MISMATCH = 13; 
PC_UNAVAILABLE = 14; 
PC_SIGNAL_LABEL_MISMATCH = 15; 
PC_LOSS_OF_MULTI_FRAME = 16; 
PC_BACK_PLANE_FAILURE = 51; 
PC_DATA_SET_PROBLEM = 52; 
PC_EQUIPMENT_IDENTIFIER_DUPLICATION 



53; 



54; 



56; 
57; 



= 69; 
101; 
= 102; 



10 6; 



PC_EXTERNAL_DEVICE_PROBLEM = 
PC_LINE_CARD_PROBLEM = 55; 
PC_MULTIPLEXER_PROBLEM_M310 
PC_NE_IDENTIFIER_DUPLICATION 
PC_POWER_PROBLEM_M310 = 58; 
PC_PROCESSOR_PROBLEM_M3100 = 59; 
PC_PROTECTION_PATH_FAILURE = 60; 
PC_RECEIVER_FAILURE_M3100 = 61; 
PC_REPLACEABLE_UNIT_MISSING = 62; 
PC_REPLACEABLE_UNIT_TYPE_MISMATCH - 
PC_SYNCHRONISATION_SOURCE_MISMATCH 
PC_TERMINAL_PROBLEM = 65; 
PC_TIMING_PROBLEM_M310 = 66; 
PC_TRANSMITTER_FAILURE_M3100 = 67; 
PC_TRUNK_CARD_PROBLEM = 68; 
PC_REPLACEABLE_UNIT_PROBLEM 
PC_AIR_COMPRESSOR_FAILURE = 
PC_AIR_CONDITIONING_FAILURE = 
PC_AIR_DRYER_FAILURE = 103; 
PC_BATTERY_DISCHARGING = 104; 
PC_BATTERY_FAILURE = 105; 
PC_COMMERICAL_POWER_FAILURE = 
PC_COOLING_FAN_FAILURE = 107; 
PC_ENGINE_FAILURE = 108; 
PC_FIRE_DETECTOR_FAILURE = 10 9; 
PC_FUSE_FAILURE = 110; 
PC_GENERATOR_FAILURE = 111; 
PC_LOW_BATTERY_THRESHOLD = 112; 
PC_PUMP_FAILURE_M310 = 113; 
PC_RECTIFIER_FAILURE = 114; 
PC_RECTIFIER_HIGH_VOLTAGE = 115; 
PC_RECTIFIER_LOW_F_VOLTAGE = 116; 
PC_VENTILATION_SYSTEM_FAILURE = 117; 
PC_ENCLOSURE_DOOR_OPEN_M310 = 118; 
PC_EXPLOSIVE_GAS = 119; 
PC_FIRE = 120; 
PC_FLOOD = 121; 
PC_HIGH_HUMIDITY = 122; 
PC_HIGH_TEMPERATURE = 123; 
PC_HIGH_WIND = 124; 
PC_ICE_BUILD_UP = 12 5; 
PC_LOW_FUEL = 12 7; 
PC_LOW_HUMIDITY = 12 8; 
PC_LOW_CABLE_PRESSURE = 12 9; 
PC_LOW_TEMPERATURE = 130; 
PC_LOW_WATER = 131; 
PC_SMOKE = 132; 
PC_TOXIC_GAS = 133; 



63; 
64; 
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const short PC_STORAGE_CAPACITY_PROBLEM_M3100 = 151; 

const short PC_MEMORY_MISMATCH = 152; 

const short PC_CORRUPT_DATA_M310 = 153; 

const short PC_OUT_OF_CPU_CYCLES = 154; 

const short PC_SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

const short PC_SOFTWARE_DOWNLOAD_FAILURE = 15 6; 

const short PC_ADAPTER_ERROR = 301; 

const short PC_APPLICATION_SUBSYSTEM_FAILURE = 302; 

const short PC_BANDWIDTH_REDUCTION = 303; 

const short PC_COMMUNICATION_PROTOCOL_ERROR = 305; 

const short PC_COMMUNICATION_SUBSYSTEM_FAILURE = 306; 

const short PC_CONFIGURATION_OR_CUSTOMIZING_ERROR = 307; 

const short PC_CONGESTION = 308; 

const short PC_CPU_CYCLES_LIMIT_EXCEEDED = 310; 

const short PC_DATA_SET_OR_MODEM_ERROR = 311; 

const short PC_DTE_DCE_INTERFACE_ERROR = 313; 

const short PC_EQUIPMENT_MALFUNCTION = 315; 

const short PC_EXCESSIVE_VIBRATION = 316; 

const short PC_FILE_ERROR = 317; 

const short PC_HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM 

const short PC_HUMIDITY_UNACCEPTABLE = 322; 

const short PC_INPUT_OUTPUT_DEVICE_ERROR = 323; 

const short PC_INPUT_DEVICE_ERROR = 32 4; 

const short PC_LAN_ERROR = 325; 

const short PC_LEAK_DETECTION = 32 6; 

const short PC_LOCAL_NODE_TRANSMISSION_ERROR = 327; 

const short PC_MATERIAL_SUPPLY_EXHAUSTED = 330; 

const short PC_OUT_OF_MEMORY = 332; 

const short PC_OUTPUT_DEVICE_ERROR = 333; 

const short PC_PERFORMANCE_DEGRADED = 33 4; 

const short PC_PRESSURE_UNACCEPTABLE = 33 6; 

const short PC_QUEUE_SIZE_EXCEEDED = 339; 

const short PC_RECEIVE_FAILURE = 340; 

const short PC_REMOTE_NODE_TRANSMISSION_ERROR = 342; 

const short PC_RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

const short PC_RESPONSE_TIME_EXCESSIVE = 344; 

const short PC_RETRANSMISSION_RATE_EXCESSIVE = 345; 

const short PC_SOFTWARE_ERROR = 34 6; 

const short PC_SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 34 7; 

const short PC_SOFTWARE_PROGRAM_ERROR = 34 8; 

const short PC_TEMPERATURE_UNACCEPTABLE = 350; 

const short PC_THRESHOLD_CROSSED = 351; 

const short PC_TOXIC_LEAK_DETECTED = 353; 

const short PC_TRANSMIT_FAILURE = 354; 

const short PC_UNDERLYING_RESOURCE_UNAVAILABLE = 356; 

const short PC_VERSION_MISMATCH = 357; 

const short PC_A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

const short PC_A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

const short PC_ANTENNA_PROBLEM = 503; 

const short PC_BATTERY_BREAKDOWN = 50 4; 

const short PC_BATTERY_CHARGING_FAULT = 505; 

const short PC_CLOCK_SYNCHRONISATION_PROBLEM = 50 6; 

const short PC_COMBINER_PROBLEM = 507; 

const short PC_DISK_PROBLEM = 508; 

const short PC_EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

const short PC_EXCESSIVE_TRANSMITTER_OUTPUT_POWER = 511; 

const short PC_EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

const short PC_FREQUENCY_HOPPING_DEGRADED = 513; 

const short PC_FREQUENCY_HOPPING_FAILURE = 514; 

const short PC_FREQUENCY_REDEFINITION_FAILED = 515; 

const short PC_LINE_INTERFACE_FAILURE = 516; 



321; 
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const short PC_LINK_FAILURE = 517; 

const short PC_LOSS_OF_SYNCHRONISATION = 518; 

const short PC_LOST_REDUNDANCY = 519; 

const short PC_MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 52 0; 

const short PC_MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

const short PC_POWER_SUPPLY_FAILURE = 522; 

const short PC_RECEIVER_ANTENNA_FAULT = 523; 

const short PC_RECEIVER_MULTICOUPLER_FAILURE = 525; 

const short PC_REDUCED_TRANSMITTER_OUTPUT_POWER = 52 6; 

const short PC_SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

const short PC_TIMESLOT_HARDWARE_FAILURE = 52 8; 

const short PC_TRANSCEIVER_PROBLEM = 52 9; 

const short PC_TRANSCODER_PROBLEM = 530; 

const short PC_TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

const short PC_TRANSMITTER_ANTENNA_FAILURE = 532; 

const short PC_TRANSMITTER_ANTENNA_NOT_AD JUSTED = 533; 

const short PC_TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 

const short PC_TRANSMITTER_OFF_FREQUENCY = 536; 

const short PC_DATABASE_INCONSISTENCY = 537; 

const short PC_FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 

const short PC_INPUT_PARAMETER_OUT_OF_RANGE = 53 9; 

const short PC_INVALID_PARAMETER = 54 0; 

const short PC_INVALID_POINTER = 541; 

const short PC_MESSAGE_NOT_EXPECTED = 542; 

const short PC_MESSAGE_NOT_INITIALISED = 543; 

const short PC_MESSAGE_OUT_OF_SEQUENCE = 544; 

const short PC_SYSTEM_CALL_UNSUCCESSFUL = 545; 

const short PC_TIMEOUT_EXPIRED = 546; 

const short PC_VARIABLE_OUT_OF_RANGE = 54 7; 

const short PC_WATCH_DOG_TIMER_EXPIRED = 54 8; 

const short PC_COOLING_SYSTEM_FAILURE = 549; 

const short PC_EXTERNAL_EQUIPMENT_FAILURE = 550; 

const short PC_EXTERNAL_POWER_SUPPLY_FAILURE = 551; 

const short PC_EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 

const short PC_REDUCED_ALARM_REPORTING = 5 61; 

const short PC_REDUCED_EVENT_REPORTING = 5 62; 

const short PC_RECUCED_LOGGING_CAP ABILITY = 5 63; 

const short PC_SYSTEM_RESOURCES_OVERLOAD = 5 64; 

const short PC_BROADCAST_CHANNEL_FAILURE = 5 65; 

const short PC_CALL_ESTABLISHMENT_ERROR = 5 66; 

const short PC_INVALID_MESSAGE_RECEIVED = 5 67; 

const short PC_INVALID_MSU_RECEIVED = 5 68; 

const short PC_LAPD_LINK_PROTOCOL_FAILURE = 5 69; 

const short PC_LOCAL_ALARM_INDICATION = 570; 

const short PC_REMOTE_ALARM_INDICATION = 571; 

const short PC_ROUTING_FAILURE = 572; 

const short PC_SS7_PR0T0C0L_FAILURE = 573; 

const short PC_TRANSMISSION_FAILURE = 574; 



typedef sequence <string> Alarmlnf ormationldSeq; 
typedef CosNotif ication : : EventBatch Alarmlnf ormationSeq; 

}; 

#endif 

/^ ## Module: AlarmlRPSystem 
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This module contains the specification of all operations of Alarm IRP Agent 
specified in Alarm IRP: IS version 1 and Alarm IRP: CORBA SS version 1:1. 

^/ 

#ifndef AlarmIRPSystem_idl 
#define AlarmIRPSystem_idl 

#include "CosNotif ication . idl" 
#include "AlarmlRPConstDef s . idl" 
#include "CommonlRPConstDef s . idl" 
#pragma prefix ''''3gppsa5.org'''' 

module AlarmlRPSystem { 

System fails to complete the operation. System provides 
reasons whose semantics is outside the scope of this IRP. 
V 

exception AcknowledgeAlarms { string reason; }; 
exception UnacknowledgeAlarms { string reason; }; 
exception GetAlarmList {string reason; }; 
exception GetAlarmlRPVersion { string reason; }; 
exception GetAlarmCount { string reason; }; 
exception ParameterNotSupported { string parameter; }; 

//name of the unsupported parameter as defined in IDL. 
exception InvalidParameter { string parameter; }; 

//name of the parameter as defined in IDL 
exception OperationNotSupported {}; 
exception NextAlarmInf ormations { string reason; }; 

The Alarmlnf ormationlterator is used to iterate through a set of Alarm 
Informations in Alarm List. Method get_alarm_list contains it as 

output parameter. 
IRPManager uses it to pace the return of Alarm Informations. IRPManager 

cannot use it to pace when IRPAgent should retrieve Alarm Informations 

from Alarm List. 
-"/ 

interface Alarmlnf ormationlterator { 

/ -k -k 

This method returns up to "how_many" Alarm Informations. 

If 1 or more Alarm Information is returned, return TRUE. 

Return FALSE if there is no more Alarm Information to be returned. 

V 

boolean next_alarmlnf ormations ( 

in unsigned long how_many, 

out AlarmlRPConstDef s :: Alarmlnf ormationSeq alarm_inf ormations 
) 
raises (NextAlarmInf ormations, InvalidParameter) ; 

This method destroys the iterator. 
V 

void destroy ( ) ; 
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}; // end of Alarmlnf ormationlterator 

This interface specifies all methods supported by System as 
specified in 3GPP AlarmlRP : CORBA Solution Set version 1:1. 
^/ 

interface AlarmlRPOperations { 

CommonlRPConstDef s :: Signal acknowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string ack_user_id, 
in string ack_system_id, 

out AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 
raises (AcknowledgeAlarms, ParameterNotSupported, InvalidParameter) ; 

CommonlRPConstDef s :: Signal unacknowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string ack_user_id, 
in string ack_system_id, 

out AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises (UnacknowledgeAlarms, OperationNotSupported, ParameterNotSupported, 
InvalidParameter) ; 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 
in Alarmlnf ormationSeq that contains 0,1 or more Alarm Informations. 
Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in Alarmlnf ormationSeq. 
IRPAgent needs to use iter to retrieve them. 
^/ 
AlarmlRPConstDef s :: Alarmlnf ormationSeq get_alarm_list ( 

in string filter, 

out boolean flag, 

out Alarmlnf ormationlterator iter 
) 
raises (GetAlarmList , ParameterNotSupported, InvalidParameter) ; 

void get_alarm_count ( 

in string filter, 

out long critical_count , 

out long major_count, 

out long minor_count, 

out long warning_count , 

out long indeterminate_count , 

out long cleared_count 
) 

raises (GetAlarmCount , OperationNotSupported, ParameterNotSupported, 
InvalidParameter) ; 

CommonlRPConstDef s : iVersionNumberSet get_alarm_lRP_version () 
raises (GetAlarmlRPVersion) ; 

}; 
}; 

#endif 
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